User management

Every user that you want to give access to the DMS server, must be added to the list on the 'User management' form, accessible via the Manage users option on the DMS Options form (home > Solution > DMS Options).

Use the 'User management' form to add and remove users    click to enlarge

With the 'User management' form you can add new (or remove) the following users:

Important   It is recommended to use windows accounts, windows security groups, and external users above using custom users.

On the form, there is an overview of every user or group that has been given access to the DMS server. In this list you can specify the admin accounts.

To add a user

  1. Click the Manage users button on the DMS Options form to open the User management form.
  2. On the User management form you are prompted with a list of names.
  3. At the base of the form, select 'Windows user(s) or groups(s)', 'Custom user' or 'External user', depending on the type of user you want to add.
  4. Click Add
    • For Windows users: The 'Select Users or Groups' dialog pops up. Update 'object types' and 'location' if required, then type the name of the user in the text field and click Check Names. Select the correct name from the list with matching names that shows up click OK. Click OK again on the 'Select Users or Groups dialog'.
    • For custom users: type the username and password in the 'New user' dialog and click OK.
    • For external users: in the dialog that opens, type the login name that is used to log in using the third party identifier service. Click OK.
  5. On the User management form, the new user is added to the list.
  6. System Administrator  Users with 'System Administrator' checked have access to all the data on the DMS server.
  7. Click Close the close the 'User management' form.

Click Apply on the DMS Options form to save the changes you have made.

Change password  As System Administrator, you can change the password for all custom users.

Using scripting to add or delete a user

You can also add or delete a user using the dmsservermanager, which is supplied with the dms server installer. The call would typically look like this:

  • Using integrated authentication:
    Dmsservermanager.exe createuser –-dmsurl https://dms.com --username newUserName --password newUserPassword --integrated
    Dmsservermanager.exe deleteuser –-dmsurl https://dms.com --username userToDelete --integrated
  • Using username / password:
    Dmsservermanager.exe createuser --dmsurl https://dms.com --username newUserName --password newUserPassword -–user adminUserName --pass adminPassword
    Dmsservermanager.exe deleteuser --dmsurl https://dms.com --username userToDelete -–user adminUserName --pass adminPassword
  • Using a previously generated token “C96F8D123FC504199B7F8E20E4BEE2B3C94AB98879E13BF6E6D52A5189339F8C”:
    Dmsservermanager.exe createuser –dmsurl https://dms.com --username newUserName --password newUserPassword -k C96F8D123FC504199B7F8E20E4BEE2B3C94AB98879E13BF6E6D52A5189339F8C
    Dmsservermanager.exe addwindowuser --dmsurl https://dms.com --username userToDelete -k C96F8D123FC504199B7F8E20E4BEE2B3C94AB98879E13BF6E6D52A5189339F8C

In a similar way, a windows user can also be added or removed. The call would typically look like this:

  • Using integrated authentication:
    Dmsservermanager.exe addwindowuser –-dmsurl https://dms.com --username DOMAIN\username --integrated
    Dmsservermanager.exe deleteuser –-dmsurl https://dms.com --username DOMAIN\username --integrated
  • Using username / password:
    Dmsservermanager.exe addwindowuser --dmsurl https://dms.com --username DOMAIN\username -–user adminUserName --pass adminPassword
    Dmsservermanager.exe deleteuser --dmsurl https://dms.com --username DOMAIN\username -–user adminUserName --pass adminPassword
  • Using a previously generated token “C96F8D123FC504199B7F8E20E4BEE2B3C94AB98879E13BF6E6D52A5189339F8C”:
    Dmsservermanager.exe addwindowuser --dmsurl https://dms.com --username DOMAIN\username -k C96F8D123FC504199B7F8E20E4BEE2B3C94AB98879E13BF6E6D52A5189339F8C
    Dmsservermanager.exe deleteuser --dmsurl https://dms.com --username DOMAIN\username -k C96F8D123FC504199B7F8E20E4BEE2B3C94AB98879E13BF6E6D52A5189339F8C

In a similar way, an external user can also be added or removed. The call would typically look like this:

  • Using integrated authentication:
    Dmsservermanager.exe addexternaluser –-dmsurl https://dms.com --username userToAdd --integrated
  • Using username / password:
    Dmsservermanager.exe addexternaluser --dmsurl https://dms.com --username userToAdd -–user adminUserName --pass adminPassword
  • Using a previously generated token “C96F8D123FC504199B7F8E20E4BEE2B3C94AB98879E13BF6E6D52A5189339F8C”:
    Dmsservermanager.exe addexternaluser –dmsurl https://dms.com --username userToAdd -k C96F8D123FC504199B7F8E20E4BEE2B3C94AB98879E13BF6E6D52A5189339F8C